home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xt / XtAppAddInput.z / XtAppAddInput
Text File  |  1998-10-30  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXttttAAAAppppppppAAAAddddddddIIIInnnnppppuuuutttt((((3333XXXXtttt)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))  XXXXttttAAAAppppppppAAAAddddddddIIIInnnnppppuuuutttt((((3333XXXXtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XtAppAddInput, XtRemoveInput - register and remove an input
  10.           source
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           XtInputId XtAppAddInput(_a_p_p__c_o_n_t_e_x_t, _s_o_u_r_c_e, _c_o_n_d_i_t_i_o_n,
  14.           _p_r_o_c, _c_l_i_e_n_t__d_a_t_a)
  15.                 XtAppContext _a_p_p__c_o_n_t_e_x_t;
  16.                 int _s_o_u_r_c_e;
  17.                 XtPointer _c_o_n_d_i_t_i_o_n;
  18.                 XtInputCallbackProc _p_r_o_c;
  19.                 XtPointer _c_l_i_e_n_t__d_a_t_a;
  20.  
  21.           void XtRemoveInput(_i_d)
  22.                 XtInputId _i_d;
  23.  
  24.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  25.           _a_p_p__c_o_n_t_e_x_t
  26.                     Specifies the application context that identifies
  27.                     the application.
  28.  
  29.           _c_l_i_e_n_t__d_a_t_a
  30.                     Specifies the argument that is to be passed to the
  31.                     specified procedure when input is available.
  32.  
  33.           _c_o_n_d_i_t_i_o_n Specifies the mask that indicates a read, write,
  34.                     or exception condition or some operating system
  35.                     dependent condition.
  36.  
  37.           _i_d        Specifies the ID returned from the corresponding
  38.                     _X_t_A_p_p_A_d_d_I_n_p_u_t call.
  39.  
  40.           _p_r_o_c      Specifies the procedure that is to be called when
  41.                     input is available.
  42.  
  43.           _s_o_u_r_c_e    Specifies the source file descriptor on a UNIX-
  44.                     based system or other operating system dependent
  45.                     device specification.
  46.  
  47.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  48.           The _X_t_A_p_p_A_d_d_I_n_p_u_t function registers with the Intrinsics
  49.           read routine a new source of events, which is usually file
  50.           input but can also be file output.  Note that file should be
  51.           loosely interpreted to mean any sink or source of data.
  52.           _X_t_A_p_p_A_d_d_I_n_p_u_t also specifies the conditions under which the
  53.           source can generate events.  When input is pending on this
  54.           source, the callback procedure is called.
  55.  
  56.           The legal values for the condition argument are operating-
  57.           system dependent.  On a UNIX-based system, the condition is
  58.           some union of _X_t_I_n_p_u_t_R_e_a_d_M_a_s_k, _X_t_I_n_p_u_t_W_r_i_t_e_M_a_s_k, and
  59.           _X_t_I_n_p_u_t_E_x_c_e_p_t_M_a_s_k.  The _X_t_R_e_m_o_v_e_I_n_p_u_t function causes the
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXttttAAAAppppppppAAAAddddddddIIIInnnnppppuuuutttt((((3333XXXXtttt)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))  XXXXttttAAAAppppppppAAAAddddddddIIIInnnnppppuuuutttt((((3333XXXXtttt))))
  71.  
  72.  
  73.  
  74.           Intrinsics read routine to stop watching for input from the
  75.           input source.
  76.  
  77.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  78.           XtAppAddTimeOut(3Xt),XtAppAddSignal(3Xt)
  79.           _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s - _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
  80.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  81.  
  82.      BBBBUUUUGGGGSSSS
  83.           In ANSI C it is necessary to cast the condition to an
  84.           XtPointer, e.g.:
  85.               XtAppAddInput(app_context,
  86.                   source,
  87.                   ((((XXXXttttPPPPooooiiiinnnntttteeeerrrr)))) XtInputReadMask | XtInputWriteMask,
  88.                   proc,
  89.                   client_data);
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.